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1. About this guide 


Objectives and target audience 
This guide describes how to install and configure the Skrill Plentymarkets module. It assumes that you 
have an existing Plentymarkets installation. 


Conventions used in this guide 
The table below lists some of the conventions used in this guide. 


Table 1-1: List of conventions 


Code example Used to illustrate example code, functions and commands. 
File path Used to indicate a file path or folder structure. 


Menu1 > Menu option2 > Indicates a menu path. 
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2. Introduction 


What is the Plentymarkets module? 


Plentymarkets is an eCommerce platform, which provides online merchants with a flexible shopping cart 
system, as well as control over the look-and-feel, content, and functionality of their online store. 


Plentymarkets has been fully integrated with Skrill’s online payment solution called Quick Checkout. 
Installing and configuring the Skrill Payment Solution module provides a simple, secure, and convenient 
option for connecting to Skrill’s online payment processing platform via Plentymarkets. 


Skrill customers using Plentymarkets have access to a wide range of card and alternative payment 
methods. 


Signing up for a Skrill account 
Before you can start accepting payments through Skrill, you need to open a free merchant account by 
completing the online application form here. 


Once your application has been approved you can configure your Skrill credentials in your Skrill 
merchant account and then copy them in the your Plentymarkets backend and start taking payments. 
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3. Installing and configuring Plentymarkets 


Secret Word and API Password 


It is mandatory to setup a secret word and API/MQI password for your Skrill merchant account before 
configuring the Skrill Plentymarkets module. The secret word is used to authenticate the data sent 
back to your Plentymarkets server after payment. You must obtain the IP address of your Plentymarkets 
server to configure the API/MQI password. 


Log in to your Skrill merchant account at www.skrill.com 


1 

2. Go to Settings > Developer Settings (Figure 3-1) 

3. Set API / MQI Password using the toggle, type and confirm by clicking Save 

4. For each section, specify the IP address(es) or IP address range of your Plentymarkets 
server. This prevents payment or money transfer requests from other IP addresses if your 
secret word or API password is compromised. All requests from other IP addresses are 
denied. Access can be granted to: 


e Asingle IP address (e.g. 145.76.160.206 using the example above) 
e Multiple IP addresses, separated by space (e.g. 192.168.0.2 10.0.0.2) 


e Asubnet in CIDR notation (e.g. 192.168.0.0/24) 

5. Set Secret Word using the toggle, type and confirm by clicking the Save button 
Note: Your Secret Word must contain at least: 8 characters, 1 uppercase letter, 1 lowercase 
letter, and 1 number. 


Skrill API GUIDES @ 





Developer Settings 
r Curl 


Configure API and security settings for your wallet account 


Bla Bla Wallet 


@ Banking ID: 116404455 


@} Balances Developer Settings : Bla Bla Wallet Il ma BE H5 2E = Pi ba Hi 5 25 m 


Wallet IP Whitelisting API / MQI / GSR / CVT Management API Documentation 


C) Automated Payment Interface (API) Disabled (» 


© Settings 
Allow requests to the API only from the following IP addresses. 








Your API secure IP addresses: ( Edit ) = + add) 








£93 Developer Settings 
87.120.141.129 


{-) Merchant Query Interface (MQI) Disabled 


Allow requests to the MQI only from the following IP addresses. 


Your MQI secure IP addresses: + Add ) 


No active secure IP address found 
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E) Gateway Secure Restriction (GSR) Disabled 


Allow gateway sessions to be generated only from the following IP addresses. 





Your GSR secure IP addresses: 





[=] Set API/MQI Password Enabled 


Please provide API/MQI Password in order to enable the service. 


Current Password 
New Password 


Confirm Password 


= O 


E) SetSecretWord Enabled 


Please provide Secret Word in order to enable the service. 


New Password 


Confirm Password 


er 


ftings | PrivacyNotice | Regulatory Disclosures | Cookie Notice 
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Figure 3-1: Configuring a Secret Word and API/MQI Password 


Installing Skrill plugin in Plentymarkets: 
The next stage of the Plentymarkets integration is to configure the Plentymarkets module to connect 
to your Skrill account. The steps are as follows: 


° Go to Plugins »Purchases. 
o All plugins purchased on plentyMarketplace will be displayed here 
° Click on Install plugin in the line of the plugin 
o The Install plugin window will open 
° Select the plugin version from the drop-down menu. 
o The newest plugin version is pre-selected 
° Click on Install. 


o The plugin will be installed and available in the plugin overview 
For more details please visit this link 


Configure Skrill in Plentymarkets 


° Type Skrill in the top right menu 
° Click on General Settings 
° Complete all requested information (Figure 3-2) 


General Settings 


Merchant ID * 


Merchant Account (email) * 


Recipient * 


Logo Url * 


Shop Url 


MOL/API Password * 


Secret word * 


Display 


Merchant Email 


Username 


Password 


Save configuration 
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11225344 





Your Skrill customer ID. It is displayed in the upper-right corner of your 
Skrill account. 


merchantemail@qgmail.com 





Your Skrill account email address. 





A description to be shown on Quick Checkout. This can be your 
company name (max 30 characters). 


merchantlogo.com/URL 





The URL of the logo which you would like to appear at the top right of 
the Skrill page. The logo must be accessible via HTTPS or it will not be 
shown. For best results use logos with dimensions up to 200px in width 
and 50px in height. 


merchantwebsite.com 





When enabled, this feature allows you to issue refunds and check 
transaction statuses. To set it up, you need to login to your Skrill 
account and go to Settings -> then, Developer Settings 


This feature is mandatory and ensures the integrity of the data posted 
back to your servers. To set it up, you need to login to your Skrill 
account and go to Settings -> then, Developer Settings. 


IFrame 


iFrame — when this option is enabled the Quick Checkout payment form 
is embedded on your website, Redirect - when this option is enabled 
the customer is redirected to the Quick Checkout payment form . This 
option is recommended for payment options which redirect the user to 
an external website. 





merchantemail@qmail.com 


Your email address to receive payment notification. 


ab100d 


Username for Plentymarkets admin page 


Password for Plentymarkets admin page 


Figure 3-2: Skrill Settings with example values in Plentymarkets backend 
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Configure Skrill Settings 


Configure the Skrill Settings as follows: 


1. 


= 


Enter your Skrill Merchant account ID in the Merchant ID field. This is the Customer ID of your 
merchant account 


Enter your Skrill Merchant account email address 

Enter the API password and Secret word that you set up in the previoussection 

Select a display option for the Skrill Payment Form (Iframe or redirect). See Table 3-1 below 
for a detailed explanation of all Skrill settings 

Either enter a name for your store in the Recipient field to display to customers within the 
Skrill Payment Form 

Optional - Enter a URL of a logo to be displayed on the Skrill Payment Form in place of the 
Recipient text. This URL must be in HTTPS format (begin with https:// 
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Table 3-1: Skrill Settings 


Field Name Description Format/ Example 


Merchant ID Your unique merchant identifier. This is the CustomerID | 58010731 
of your merchant account. 


Merchant The email address linked to your Skrill merchant account | techpubs@skrill.com 


Account (created by you when you first signed up for a Skrill 
(email) merchant account). 


Recipient Optional - A description of your shop. This will be Demo Shop 
displayed on the Skrill Payment Form if you do not 
provide a Logo URL. 
Logo URL Optional - Link to the URL of a logo, to be displayed on https://www.skrill.com/ 
the Skrill Payment Form. Must be in HTTPS format. fileadmin/content/pdf/ 
acme.png 


Shop URL URL for the home page of your shop without the https://myshop.com 
index.php e.g. if your shop is located at 
https://myshop.com/index.php you would enter 
https://myshop.com 


MQI/API The API password. This field is mandatory. It allows the 
Password Plentymarkets serverto receive payment information. 


Secret word Enter the secret word configured for your Skrill account | N/A 
here. This feature is mandatory and ensures the integrity 














of the data posted back to your Plentymarkets servers. 


Display This setting has two options: IFrame and Redirect IFrame 
e IFrame - when IFrame is enabled the Skrill 

Payment Form is embedded in your shop website. 
See Figure 3-3: for an example. 
Redirect - when redirect is enabled the customer is 
redirected to the Skrill Payment Form. This form is 
displayed on its own in the current browser tab. 
This option is recommended if you plan to display 
Payment Methods which redirect the user to an 
external website such as Klarna, Rapid Transfer, 
etc. 


Merchant The email to which all payment notifications should be techpubs@skrill.com 
sent. 





email 





Username for your Plentymarkets admin N/A 
Password for your Plentymarkets admin N/A 
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@ English Germany 


1,460.00 © Skrill 


=p marini SEPA © 


Card number 


Expiry date Security code 
MM || YY CVV 


Cardholder name 
Test customer 


Email address Why? 


PAY NOW 


Cancel 


a Powered by 
Or Skrill 





Figure 3-3: Iframe (embedded) option 
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4. Displaying Payment Methods 


You can select the payment methods to display to your customer using the Payment Configuration tab. 
The module has a series of payment method sections for each of the payment methods supported by 
Skrill. An example is displayed in (Figure 4-1): 


Credit Cards 


VISAS 


All countries except: Afghanistan, Cuba, Eritrea, Iran, Iraq, Japan, Kyrgyzstan, Libya, North Korea, Sudan, South Sudan and Syria 


Language English y 
Payment Method Name Credit Cards 
Enabled ¢ 


Show separately 


Save configuration 





Figure 4-1: Example Payment method section 


For each payment method, specify whether it should be enabled (Table 4-1) in the list of Payment 
methods displayed in the Plentymarkets Checkout. For each separate payment method full supported 
country list will be visible at the top of the page (Table 4-1). See the Skrill Quick Checkout Integration 
Guide for a full list of countries and an up-to-date list of the countries where each payment method is 
supported. The payment methods are displayed in order of popularity in the customer’s country. 


Table 4-1: Payment Method Settings 


Enabled Determines whether this Payment method is displayed - Yes = display, No = 
Do not display. 
Under the Enabled setting is a list of the countries that support this payment 
method. If a Payment method is enabled but the customer’s country is not 


supported (determined by the country set in the billing address the customer 
chose in the Plentymarkets Checkout) then it will not be shown. 


Show Always set this setting to Yes where available. 
Separately 





Please note that if the payment option is not enabled for your Skrill merchant account, enabling in from 
the backend would not make the payment option visible. You will need to contact 
merchantsupport@paysafe.com in order to discuss activating the specific payment option. 
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All Cards and Alternative Payment Methods 
This special payment option launches the Skrill Payment Form with multiple tabs showing all the 


supported Payment methods available in the customer’s country . The logo for this Payment option in the 
Plentymarkets Checkout payment information section is as seen in (Figure 4-2) below: 


All Cards and Alternative Payment Methods 





All countries except: Afghanistan, Cuba, Eritrea, Iran, Iraq, Japan, Kyrgyzstan, Libya, North Korea, Sudan, South Sudan and Syria 
Language 


All Cards and Alternative Payment Methods 


Figure 4-2: Setting up combined Skrill logo 


English Germany 


629.10 © Skrill 


Skrill O10) =) © 


More payment options 





RAPID. 





This payment will be processed asa 


payment and 
is subject to the Sk 
PAY NOW 
Cancel 


Hrono ea 
= Skrill 


Figure 4-3: Multiple log 
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5. Customer Experience 


This section describes the customer’s checkout experience when using the Skrill Plentymarkets module. 


Note: We only describe the Checkout process from the payment selection step onwards as the previous 


steps are unchanged. 
The steps are as follows: 


1. Click a payment method from the list of available payment methods (this list depends on the 
customer’s country, the payment options configured for your Skrill account and the payment 
options configured in the Skrill Plentymarkets Module 


Delivery address 


Redeem coupontt 


New address 


Delivery address same as invoice address 


. Total 

Value of items (Net) EUR 651.79 
oa Value of items (Gross EUR 730.00 

Shipping method i 
Shipping (Net) EUR 0.00 

EUR 0.00 

Total (Net) EUR 651.79 
Payment method VAT 12% EUR 78.21 
VISAS Credit Cards Total (Gross) EUR 730.00 


= ee —| All Cards and Alternative Payment Methods 





RAPID: Rapid Transfer 


Klarna 


Figure 5-1: Plentymarkets Checkout Payment selection showing different payment methods 
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2. Enter Payment details in the Skrill Payment Form. 


@ English Germany 


730.00 © Skrill 


= © 
visa Qe 


Card number 
5438-3112-3456-7890 eS 


Expiry date Security code 
10 | 20 123 


Cardholder name 
Test customer 


Email address Why? 
testcustomer@gmail.com 


PAY NOW 


Cancel 


Uronen : Powered by 


Skrill 





Figure 5-2: Enter Payment Details in the Skrill Payment Form 
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3. Click Pay Now to complete the payment. If all is correct, the payment form will display the 
following screen: 


@ English 


130.QQEvR 


Successful payment 


Oe Skrill 





Figure 5-3: Successful Payment 


4. Click Continue to return to the Plentymarkets Order Confirmation screen. This screen 
contains the unique order number for this payment. 


Ceres & Living room = fice © 
Thank you! 


Your order is being processed. Here, you will find an overview: 


Two-seater Red Carpet 1 


Order ID 1494 eae 
Price per piece EUR 730.00 
Quantity 1 
Order date: 08.06.2020, 16:49 Total EUR 730.00 
Status: Waiting for payment 
Invoice address Test customer Total 
High 8 
4321 Borin Value of items (Net) EUR 651.79 
Germany Value of items (Gross) EUR 730.00 
Delivery address Delivery address same as invoice address Shipping (Net) EUR 0.00 
Shipping (Gross) EUR 0.00 
Payment method Credit Cards 
Payment status Not paid 
Cha hod ibl 
EEE A ai aiii Total (Net) EUR 651.79 
Shipping method DHL - insured package VAT 12% EUR 78.21 
Total (Gross) EUR 730.00 





Figure 5-4: Order Confirmation in Plentymarkets Checkout 
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Removing or reducing the header and reducing the footer 

You can request a version of the Skrill payment form without the Skrill header and amount fields. The 
security logo is also removed from the footer, to reduce its size. To enable this option, please contact 
Skrill Merchant Services and ask for the Reduced Header and Footer option. This option is shown in 
the screenshot below (The standard payment form is shown on the left and the reduced header and 
footer option on the right). 





© English France 
10.0Q«vr 
D English France S English France 
© 

— recae 

-3 = —_ 
—p Q — 5 
visa SD 
VISA 
© vsa @D 

Expiry date Security code Expiry date Security code 

MM YY CVV pmm aa (ES Spy — Expiry date Security code 

MM | YY CVV 

Cardholder name Cardholder name 

First Last First Last Cardholder name 

First Last 
Email address Why ? Email address Why? 
Email address Why? 
PAY NOW PAY NOW 
PAY NOW 
Powered by Porwered by 
vv“ wnn e 
Skrill KÁ Skrill Powered by Skrill 


Figure 5-5: Reduced Header and Footer Option 
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6. Payment Information 


The Plentymarkets module provides payment information in the Order screen with information about 
the payment method used for an order. 


Overview Settings Email Payment Receipts Tickets Orders Stock Reorder Properties Delivery 


Status 

Order type 
Owner 
Referrer 
Client (store) 
Location 
Language 


Warehouse 


Outgoing items 


Shipped on 


Return date 


Currency 


[ [5] Cleared for shipping v Payment method Plugin: Credit Cards v 
Order v Incoming payment reset 
| No one assigned as responsible v 
j Value date 
[1.00] Mandant (Shop) v : 
; Payment due Early payment discount (days) |0 
‘Main Shop v i 
eS Early payment discount (%) 0,00 


Deutschland (ID 1) 


Geman y Shipping service provider DHL EJ 


KS Sales v 
ON NAR ==£ [6] DHL (insured package) EJ 
l l = Shipping profile & shipping a 
hot hooked 07.07.2020| [47 v]: [34 + | E charges 0,00 


Entry is gross, including costs relating to payment 
method 


Ext. Order number 


B Customer reference 


Packages 1 


$ 
EUR Package number 


Figure 6-1: Payment Information Example 


The Payment Information section includes the following information shown: 


The payment option selected in the Plentymarkets Checkout 


The payment status 

The country the payment order originated from. This information is obtained by Geolocation 
using the Customer's IP address 

The currency the order was placed in using a 3-digit ISO 4217 currency code e.g. EUR for 
Euros. 
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Refunding Payments 


The process for Refunding customer payments is as follows: 


1. Goto Orders in the Plentymarkets Admin Panel 
Bank postings PayPal 


I4 < Page 1 of1 > PI) 50 YY Payments 1-27 of 27 





Assignment Status Designated use Account holder Customer Il Payment! Received 
jus) 1033 1524 730.00 EUR confirmed Transaction ID : 1594139388217064225 Used payment method : MasterCard Pa... oi. Jul 7, 2020, 5:30:25 PM 
CJ 1032 1523 154.99 EUR confirmed Transaction ID : 1592567699725963761 Used payment method : Visa Payment s... oy. Jun 19, 2020, 12:55:31 F 


Figure 6-2: Search for Order 


2. Search for the customer’s invoice 
3. Click the correct Order to view more information 
4. Goto order in the subtab menu 


Overview Settings Email Payment Receipts Customer Tickets ehem Stock Reorder Properties Delivery 


i | orders | 
ders 
Group function 


I4 < Page 1 of19 > PIS) 50 YL 1-500f928 





[] Ordertotal (on this page): 5,846.53 (VAT: 626.43) of which are unpaid: 154.99 (VAT: 16.61) 

O 1523 WH «= =~ =D DE EUR 100 % 154.99 16.61 
113 Input Invoice number Incoming paym... Outgoing items Shipped on Referrer Owner Warehou... Numb... Weight Shipping ... 
plugin sales 6/19/20 å Not existing 6/19/20 1 1 Og 4.99 


Beuthener Straße 25 losarang 


: 


Figure 6-3: Refund Payment 


5. Check that the details are correct 
6. Select Refund from the green status drop down menu and then save 


Ix s+ i uye ' wis r 8 A vy E t vv vI vevu 


|_| Order total (on this page): 5,846.53 (VAT: 626.43) of which are un [9] Return = Bo 
O 1523 JA N- % 9 DE ER 154.99 16.61 


113 Input Invoice number Incoming paym... Outgoing items Shipped on Referrer Owner Warehou... Numb... Weight Shipping ... 


plugin sales 6/19/20 A Not existing 6/19/20 1 1 0g 4.99 
Beuthener Straße 25 losarang 


Figure 6-4: Refund Completed 
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7. Testing 


We provide test cards shown in the table below for use with test merchant accounts. When using these 
card numbers enter an expiry date in the future and a random CVV number. 
Table 7-1: Test Cards 


5438311234567890 





4000001234567890 


Should you wish to test Skrill in DEMO shops please get in touch with Skrill support at 
newbusiness@paysafe.com, so we can provide you with access. 
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